home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 1.iso / desktop / thmbnail.zip / README.TXT next >
Text File  |  1995-06-28  |  7KB  |  177 lines
  1. ThumbNailer ver 95.6.28
  2.  
  3.                             by Rob Reuss   (copyright 1995)
  4.                             rsr@i-2000.com
  5.  
  6. BRIEF
  7.  
  8.  ThumbNailer utilizes Netscape 1.1 or greater as a thumbnail
  9.  graphics viewer.  
  10.  
  11. INTRODUCTION
  12.  
  13.  ThumbNailer will examine the contents of whatever directory
  14.  or subdirectory you choose, it will identify "gif" and "jpg"
  15.  files and will write out a file called "thumb.htm" to the
  16.  directories. Each file contains html code to display the 
  17.  directory contents as thumbnail images.  It will automatically 
  18.  launch Netscape with an index file loaded listing the directories 
  19.  it wrote files for and you can click on them to see the thumbnail
  20.  contents.  If you click on the thumbnail or the filename,
  21.  it will load that image.
  22.  
  23. INSTRUCTIONS
  24.  
  25. Installation
  26.  
  27.  Unzip the file THMBNAIL.ZIP and put the file THMBNAIL.EXE in
  28.  it's own directory, which you may call whatever you wish.
  29.  
  30. Using ThumbNailer
  31.  
  32.  Use the drive and directory controls on ThumbNailer's main
  33.  window to identify the directory which it should begin with
  34.  in creating thumbnail files.  There are a number of options
  35.  in terms of exactly how ThumbNailer will operate, and these
  36.  are accessed through the menu item SETTINGS.  
  37.  
  38.  Settings
  39.  
  40.  Thumb Size
  41.  This option gives you control over how large of a thumbnail
  42.  Netscape will display, with the height on the right and the
  43.  width on the left.  You can use the scrollbar to increment
  44.  or decrement in 25 pixel quantities.  
  45.  
  46.  # of Columns
  47.  This let's you determine how many thumbnail images Netscape
  48.  will show on each line.  This will be in effect regardless of
  49.  whether you have "Use Tables" checked.  You can enter a 
  50.  quantity here or choose from the drop down box.
  51.  
  52.  Browser
  53.  Checking "Launch Browser" will cause ThumbNailer to launch
  54.  Netscape when it is through building the thumbnail files.  If
  55.  there is no browser entered and you check this box, you will
  56.  be given the opportunity to show ThumbNailer where your
  57.  Netscape browser is located.  Or you can use the "Find" button.
  58.  Regardless of whether or not you have "Launch Browser" selected
  59.  or a browser specified, ThumbNailer will copy the URL of the
  60.  main file it creates to the Windows clipboard.  This is
  61.  particularly useful if Netscape is already running, because 
  62.  ThumbNailer is unable to force an already running Netscape
  63.  to the newly created page.  
  64.  
  65.  Include Subdirectories
  66.  This setting determines whether or not, if subdirectories exist
  67.  below the selected directory, ThumbNailer will produce thumbnail
  68.  files for those directories as well.  If this box is checked,
  69.  ThumbNailer will go through *all* subdirectories, even deeply
  70.  nested one, so use this with care.
  71.  
  72.  HTML File
  73.  
  74. o  Single Thumb File: check this to have ThumbNailer produce just
  75.    a single page of thumbnails, even including subdirectories.  
  76.    Using this option, you can essentially create a single page
  77.    with all of the graphics on a disk displayed.  (See notes below
  78.    regarding Netscape's ability to handle huge files.)
  79.  
  80. o  Multiple Thumb Files: check this, in contrast to "Single Thumb
  81.    File", to have ThumbNailer create individual thumbnail files in
  82.    each subdirectory, along with an index to access them.
  83.  
  84. o  Display Full Size: check this if you want Netscape to display
  85.    the images full size, rather than according to the geometry
  86.    given in "Thumb Size".
  87.  
  88. o  Include File Names: if this is checked, ThumbNailer will insert
  89.    the name of each file underneath it.
  90.  
  91. o  Use Tables: if this is checked, ThumbNailer will employ Netscape
  92.    tables in displaying the thumbnail images.
  93.  
  94. o  Background Color: DOUBLE CLICK on this panel to select the color
  95.    you would like Netscape to display as a background to your thumb-
  96.    nail images.
  97.  
  98.  File Names
  99.  
  100.  The INDEX and HTML file names tell ThumbNailer what to call it's
  101.  output files.  If you are doing any WWW development, you may already
  102.  have files called INDEX.HTM on your hard drive.  If ThumbNailer
  103.  encounters a situation where an existing file has the same name as
  104.  the one it is trying to write, it will examine the file to see if it
  105.  is a ThumbNailer-produced file by looking at it's first line.  If
  106.  it is not a ThumbNailer file, it will give you the option of over-
  107.  writing it or skipping over it.  If you encounter these naming conflicts
  108.  often, change these entries to legitimate DOS file names and be happy.
  109.  
  110.  You must close the Settings dialog box in order to continue
  111.  
  112. BUILDING YOUR THUMBNAIL FILES
  113.  
  114.  Once you have used the drive and directory controls to locate
  115.  the directory you want ThumbNailer to work on, and adjusted the
  116.  settings to your needs, choose "File" and then "Build" on the
  117.  menubar and ThumbNailer will do the rest.
  118.  
  119. DELETING THUMBNAIL FILES
  120.  
  121.  If you wish to remove ThumbNailer produced files at any time,
  122.  choose the directory and/or subdirectories you want the files
  123.  deleted from, and choose "File" and then "Delete Build" on the
  124.  menubar.  ThumbNailer will delete only ThumbNailer-produced files
  125.  according to the filenames currently entered in the "Settings"
  126.  dialog box.
  127.  
  128. USING OTHER BROWSERS
  129.  
  130.  ThumbNailer, at it's core, relies on Netscape 1.1's ability
  131.  to control the geometry of the images it displays, so it's 
  132.  utility with other browsers is limited to displaying full
  133.  size images, regardless of whether "Full Size" is selected
  134.  in the "Settings" dialog box.  It is recommended that you
  135.  uncheck "Use Tables" if you are employed another Browser.
  136.  
  137. PROBLEMS WITH USING NETSCAPE FOR THIS PURPOSE
  138.  
  139.  You will find that your thumbnail pages, if they contain
  140.  many images, will take a while to load into Netscape.  This
  141.  is because Netscape *must* load the entire file to create
  142.  the thumbnail.  With files that contain many graphics, you
  143.  may find Netscape showing the broken image symbol it uses
  144.  when it can't load a graphic.  You may find that increasing
  145.  the cache size under "Cache and Network" in Netscape to 
  146.  improve this situation.  You may also find Netscape crashing
  147.  with larger files...I did.
  148.  
  149. ABOUT THE PROGRAM AND THE AUTHOR
  150.  
  151.  ThumbNailer is for personal, non-commercial use, and for such
  152.  uses it is freeware.  If you wish to use it in any commerical 
  153.  situation, please contact the author for licensing arrangments.
  154.  
  155.  The program was created using the Delphi programming environment
  156.  from Borland.  I created it to begin honing my Delphi skills on
  157.  a relatively small project.  I do not intend to further develop
  158.  ThumbNailer unless I hear from people who find it useful and
  159.  want additional features.  Some additional features that might
  160.  be possible include: more control over Netscape tables; getting
  161.  Netscape to send files to an external viewer, like Lview; adding
  162.  more complex indexing for sub-directories, somehow dealing with
  163.  other file formats, somehow taking advantage of the fact that
  164.  Netscape loads the entire image for each thumbnail by putting
  165.  the full images down below the thumbnails.
  166.  
  167.  If you find any bugs, or wish to make suggestions about how this
  168.  application may be improved, please send them to rsr@i-2000.com
  169.  and I will do my best to respond.  It would be helpful if you
  170.  included the word "THUMBNAILER" in the subject line of the message.
  171.  
  172.  The most up-to-date version of ThumbNailer will be made available
  173.  at ftp.soc.qc.edu in directory /pub/GoSlip/thmbnail
  174.  
  175.  Enjoy!
  176.  
  177.